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MESSAGE OF THE DAY 
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THE NEWSLETTER FDR % COMPUTER USERS 


THE NEW 
COLOR COMPUTER 

by Bruce Warner 


By the lime this article hits the 
street, 111 have seen the new Color 
Computer. Oil July 30th, a 
press conference was hosted in New 
York City. The conference intro- 
duced four new MS-DOS comput- 
ers and the new Tandy Color Com- 
puter, 

This machine supports advanced 

graphics, up to WO x 192 pixels in 
rOUK t:oiur&. the majority ot ex- 
isting hardware is compatible, in- 
cluding Deluxe RS-232 Paks and 
disk controllers, but much of the 
hardware may be undesired with the 
improved Features of this machine, 
Incompatibilities will come from 
hardware and software that has 
violated specific conventions of 
programming standards both under 



OS-9 and RS-DOS. Most of the 

programs are the ones that run in 

the "%K" mode, or those that make 

direct calls to hardware devices 

rather than using device descriptors 

and drivers- CoCo Max is among 

the programs that will not run, due 

to the 96 K addressing used by Co Co 

Max. Most of the Tandy hardware 

will work without modification^ 
since they have 1 olio wet) their own 

programming rules, An exception 

to the Tandy rule is the Mulli-Pak 

interface under OS-9 Level ILAM 

modification is required, 



Irom Ihe outside, thr new Tandy 
Color Computer looks i lul like ft* 
foretunn*r, the Color Compuler 2, 
bul the insidts make ill (he differ- 
ence In I he world. 

The Son wire Compatibility Story 

If you're using Telewriter under 
RS-DOS, you 11 be surprised that it 
is one of the few programs that 
wonl have compatibility problems. 
Tele write r-64 works because of its 
implementation of the 64 It CoCa. 
Although the original version used 
undocumented calls to the ROM, 
which resulted in incompatibility of 
the software, the current version 
works because they didn't try to 
make Tele writer ^64 work using 96 K. 
This is due to the addressing mode 
of the GlMl chip. This is the chip 
that gives you all the power to 
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There \ Ntte sly (faux shades K a r* d ennr, a bkck> white and mi CoCo % 
gmn hills, or uji;r fai ef round and black tent Altogether* 16 colors ire available 
with hiflhtr resolution thin the old CoCo and more programming memory thin 


address the extra memory. To make 
4 M 96K" program run, "the GIMI 
Lhip must be set to I6K internal and 
16K external ROM before perform- 
ing any banking between the RAM/ 
ROM and all RAM mode using the 
usual SAM addressing, The easiest 
way around this is to go to OS-9 and 
lei the new Level II OS-9 system 
handle it all for you. This will also 
insure that your software runs first 
time out on any new Tandy OS-9 
machine. R3-D0S also causes some 
problems with addressing memory 
that is reserved for the GIMI and 
SAM chips, 

Tandy has listened to us, so you 11 
see more than you may have ex- 
pected in a Color Computer, with 
memory starting at I2SK and work- 
ing its way up to 512K (in one step) 
and a variety of features You 11 even 
see graphics that rival the outhouse 
and game companies. Well be able 


to see this machine yourself in your 
local Radio Shack in a couple of 
weeks. 

So what's so new and so great 
about a 6809 computer? Well t you 
may decide that you don't even need 
a 68xxx machine after wrung this 
one. Mostly because of the things 
that have made the OS-9 commun- 
ity so great to begin with, but with 
the added features of this machine 
it's a real bargain. 

Besides the memory, youll be 
glad to know that basic is still 
BASIC for those that want to stay 
that way What makes RASIC better 
is that Micro ware (that's right, the 
OS-9 people) were contracted to do 
the patch for Enhanced Color 
BASIC. This includes 21 new com- 
mands airmed at making the best 
use of the hardware in this machine. 
This includes the new 80-character 

Continued on Page 14 


OS-9 
ATNCC 

(Pholoi and siury — Pages iO and II) 

Richard Don, ownei *if Gimisc, lnc M 
shows off the (iimii that fits in a PC 
case. The use of the PC power supply 
and case offers I he user the option of 
an exceptionally low- priced cising 
for I heir single- board computer 
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The building of this month's 
MOTD may have been a little 
harder than usual. Wrll start with 
the stupid complaints by people that 
have proclaimed themselves as OS- 
9 experts and go on to the daily 
routine of helping a friend whose 
son wants to join the Navy. 

What in the world do these things 
have in common? Simple. They are 
two of the many things that occupy 
my world, from the few petty folks 
in the world of OS -9 {that take up 
most of your time) to the people that 
really have a problem and want a 
little shove in the right direction, 

Puck rtl Jumps on the Soap Box 

Dale Puckett has an excellent 
article this month on OS-9 critics. 
They remind me of Ralph Nader. 
Though Mr. Nader has spent a lot 
ol tunc making us aware of how 
unsafe our cars and other items are, 
[ sure am glad thai l do nl have to 
wait for the car he designs. I'm also 
glad I'm allowed to lake some re- 
sponsibility and not have to pay the 
extra 1 100,000 if would lake to put 
a]] the c\iru fcaBures Mr. Nader 
would want as standard equipment 
on our cars 

Dale hits the nail on the head 
when he tells us that "Those who 
can, do. ThosG who can\ criticize." 
If you Ye a critic, try being a doe r. It 
doesn't lake that much more energy, 
and it sure gets m into a healthier 
mood. 

A Week in Vegas 

Trying to cover everything in the 
world of 05-9 isnt easy. ] just spent 
every penny 1 made editing the 
MOTD this year by going to one 
show. Not all of the shows are paid 
for by the UG n and the cdiiofs post 
is the only paid position. The pay is 
less than adequate for what it takes, 
and I could make more spending the 
same amount of time writing for our 
local newspaper. The point is that I 
could be doing something a lot more 
profitable and much easier with my 
lime. Like so many of the UG offic- 
ers, I believe that 03-9 is worth the 
effort 

In case you Ye wondering why 1 
refer to going to Las Vegas as an 
expense, I hit on the fact that ] don't 
gamble and 1 don t drink, so the 
shows were nice, but the location 
isn't my idea of a good time. I really 
would have better enjoyed a week at 
a riding academy up north in June. 
The desen heal isnH my idea of great 
weather. 


PUTTING IT TOGETHER 

The building of this month's MOTD 
by Bruce N. Warner, Editor 


Corning up This Fall 

If you Ye wondering about RAIN- 
BOWfest, you M be pleased to know 
that we're all very proud to anouncc 
that the publishers of the RAIN- 
BOW are planning an expanded 
coverage of OS-9 seminars. Some of 
these will be because of the new 
Color Computer (see the article in 
this issue), others axe because of an 
increased interest in OS-9. 

Vm very proud to announce that 
111 be giving a seminar on "OS-9 
From a Users Standpoint, "This talk 
will be dedicated to finding out what 
OS-9 means to those people who 
only want to use the software avail- 
able on their computer. I, for one, 
rarely do my programming under 
OS-9. Instead, I purchase programs 
that are already written under our 
favorite operating system and learn 
how to use them and make the 
system work better for us all. I also 
get software and hardware from 
various companies and write the 
documentation for making it run 
under OS-9, This development of 
hardware and software documenta- 
tion is one of my Largest uses of OS- 
9, and it*s greatest visibility is in the 
Color Computer OS-9 communitv. 

We Don^ Always Gtt to Tall 

There are some people thai think 
the UG officers talk on a daily basis, 
There arc times that wc d<m\ even 
get to talk on a weekly basis, 1 
haven't spoken to Brian Laniz but 
once in the last month, [ do get to 
talk with Dale Puckett at least once 
a week, hut Dale lives and works in 
the local area, and phone calls are 
cheap for us, 

Whafs all this leading up to? 
Well, don't be sur prised if yon get 
different stories from different offic- 
ers in Che same day. We may get our 
heads together before ihe next timer 
you give us a call, but at any given 
moment, we are just as likely as you 
t o be ope ratingond if fere nt frequen- 
cies- Add to that, there is always 
more than one way to look at and 
solve a problem. At one RAIN- 
BOWfest, Dale Puckett and I were 
answering several questions for 
people. Dale gave one set of answers 
and I gave another. While w were 
both right, there were times that 
Dale*s answers were better and 
times they were worse than mine. 
They were all right, mind you, only 
looked at from a different person 
with a different point of view. 

J keep remembering this incident 
when someone asks me what is the 


best word processor for their OS-9 
computer 1 tell them I can! answer 
that, but I use DynaStaL 

The next question is always, 
"Then why do you use DynaStar if 
it's not the best?" Simple. It is the 
best — for mel What's best for you 
could be StyloGraph or Last Word 
or OeskMate. I don't know what 
you're going to do with it or how 
you're going to make it work for 
you, I oniy know what's right for 
me, So T is my answer wrong? No 
My answer is right under ihe cir- 
cumstances I\c chosen to consider 
to answer it, I use DynaStar because 
it's comfortable and it handles 
about 98 percent of my word pro- 
cessing needs. What yon select is 
your option. What I select is mine. 
With the new Color Computer, we 
nav find yitftfL tmJj^ wQTfl 
processor* hitting the OS-9 com- 
munity, 

The point is chat we can only 
answer your questions from our 
own vantage point. 

Nevtr B*cum( an Expert 

I have a friend who says an 11 EX" 
is a has-been and a "SPERT" is a 
drip under pressure, so whal fc s that 
make an EX-SPEUT? There's a 
much better reason for not becom- 
ing an expert There is always some- 
one out there that wants to rip your 
head off. As soon as your name 
becomes known, youVe either a 
target or a source of information. 
It's kind of tike being the fastest pin 
in the West, There's always someone 
that wants to shoot you out of the 
fastest seat. 

I know of people that quote Steve 
Rjork, Dale Puckett and Brian 
Lantz for all sorts of things. One 
told me that Dale Puckett had been 
invited to the Tandy press confer - 
eiice in New York. I was glad to hear 
it, but a bit surprised Dale and ( had 
just spoken the day before and he 
had no plans or invitation to attend 
the conference. l p on the other hand , 
was planning a one-day trip to New 
York for the event. 

The next day, Dale showed up at 
the monthly Saturday meeting of 
the Northern Virginia Color Com- 
puter Club, much to my surprise. 
What happeened next was a litttle 
embarrassing for the member that 
told me Dale was going. Dale hadn't 
spoken with him or the people at 
Tandy There was an assumption 
made because of Dale's reputation 
in the field and a desire to be asso- 
Cotuinued on Page 20 
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NEW LOW COST 68020 BASED 
MULTI-USER SUPER-MICRO 


The QT 20x m is an extremely cost effective multi-user, multi-tasking 
micro that will support 2 to 30 users. RAM is expandable from 512K to 
14.5 Megabytes; ROM is expandable to 256K. A number of useful 
software packages are included in its low cost. The QT 20x™ can be 
purchased as a complete system with floppy and hard drives; in a kit 
form, or the motherboard can be purchased separately. Other 
hardware configurations can be customized to meet your needs. 
Listed below are the principal hardware and software features: 


HARDWARE Features: 

- 32 Bit MC68020 Processor * 12.5 MHz 

* 512 Kbytes of 32-bit wide, high speed RAM 

* 2 RS-232 Serial I/O Ports 

- 1 Parallel I/O Port 

- Built-in SCSI/SASI Interface With DMA 

• Floppy controller with DMA 

- 32 Bit Expansion Buss 

- Real Time Clock w/Battery Backup 

• DIP Switches to select Boot Up Baud Rates 
and Boot Device 


HARDWARE Options: 

- 2 Megabyte RAM / 4 Serial Port Expansion 
(a maximum of 7 boards may be used) 

• MC68881 Floating-point Coprocessor 

• Memory Protection 

• Graphics Board ** 

• 4 Serial Port Expansion Board " 

" (Available 4th qtr) 


SOFTWARE included: 

OS9/G8K • Operating System 
Baslc09 ■ Programming Language 
Stylo - Word Processing 
Mail Merge 
Spelling Checker 
Dynacalc - Spreadsheet 
fbu - Hard Disk to Floppy Backup 
QCom - Communications with XMODEM and 
text file transfer 


*** 


< ■ ■ 


Other Software Available: 

. c 

• Pascal 

• PC Utility (Read/Write/Format IBM Disks) 
- CRASMB Cross Assembler 

• Sculptor Plus ■ 4th Generation P.L 

(Data Base Management) 

• Fortran 77 (Available 4th qtr) 


Note: *** QCom & fbu are included FREE when a complete system is purchased. 


LIMITED TIME SPECIAL 

Complete system with 20 
Meg Drive only $4495! 

2.5 Meg RAM, 6 Serial Ports 1 Parallel port, RTC. 
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OS-9UG SOFTWARE 
COMMENTARY 


6y Bert Schneider 


Wow! J9J68 sectors — [ never 
though i I'd see that many sectors on 
my Color Computer I Finall y got the 
hard drive up and running on my 
system thanks to people like Ron 
Schmidt of L.R, Techf The only 
problem I have now is that ] have 
been unable to get OS-9 Version 2,0 
to boot up on my system using the 
hard drive (I have all the upgrades 
for 2.0). Anyhow, I can at least boot 
up 1.1 without any floppy drives. 

NEW UPDATES! Some of the 
User Group Library Disks have 
been updated to correct bugs or add 
more efficient code, or just to add 
some new routines. 

Dave Kaleila has improved his 
documentation generation program 
DOCGEN2 (a program used by 
software authors who want to con- 
tribute to the OS-9 UG Library). 
Dave has included on Disk #0 a new 
verison called DOCGEBl He states 
that it cannot be packed on a CoCo, 
but 1 did it on mine without prob- 
lems (I am also using Wordpak 
which frees up a great deal of me- 
mory). He also includes anew utility 
called LOW UP that converts all text 
to uppercase only. His DOCGEN3 
pHigiaiii icq lines ah Lip^iCdM: 101 
data input 

Disks ttb and #7 have been fixed, 
The adventure program had a few 
bug$ that, would really irritate an 
avid adventurer. After spending 
hours down in Colossal Cave p you 
might suddenly find your adventure 
curtailed by a FATAL ERROR J38 
or other such messages. Those have 
been corrected on both the source 
code disk and the object code disk. 
Other disks in the library have been 
updated too. Since I have not co~ 
veied those yet, ] will just treat the 
new updated versions as the stand- 
ard baseline disk for commentary 
purposes, 

Disk ttlO y "Math and Electron- 
ics T " fits right up my alley since I am 
an electrical engineer. All of the code 
on this disk is written in BasiriH and 
was put together by George Dorner 
(another OS-9 UG superman), I 
only wish I had access to some of 
these routines when 1 was doing 
some of my undergraduate work 
and even my graduate work. Some 
basic understanding of mathematics 
and electronics is probably required 
to use these routines. I don\ think 
the average computer owner/ user 
will have a need for these routines. 
However, the serious electronics 
hobbyist, student, or designer will 
find these programs most beneficial. 


The students can learn more easily 
from comparing their answers to 
those found from the programs. 
Usually students are limited by only 
a few examples in text books. These 
programs enable the student to go 
beyond just the basic examples. As 
for the electronics hobbi&l or de- 
signer, no one really sits down and 
designs by hand anymore. Sure, the 
designer has to come up with the 
idea 1 but the computer can do all of 
t he tedious job of nu mber cru nch ing 
(which if done by hand is prone to 
error). This disk demonstrates that 
there is more to computing than just 
system utilities or file processing. 

NAME: re 
TYPE; Electronics 
LANGUAGE: BasicW 
SIZE: SICE 

DESCRIPTION: This routine is a 
simple Basic09 program that prints 
out parameters of an RC circuit 
(resistor-capacitor) as the resistor 
heats up. 

USE: run rc <cr> or re <cr> 
You must modify the initial condi- 
tions inside the program itself for 
each case. Therefore, it would not be 
wise to pack this program. It would 

tions as variables allowing this 
program to be a stand-lone module. 
The initial conditions are: change, 
time, resistance, capacitance and 
voltage. 

AUTHOR: George Dorner 
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NAME: ResRatlHC 
TYPE; Electronics 
LANGUAGE: BasidW 
SIZE: $176 

DESCRIPTION: This routine finds 
resistors for a specified ratio and 
specified percentage tolerance lim- 
its, 

USE: res r at 1 he <cr> self prompting 
AUTHOR: Carl R. Kreider 


NAME: network 
TYPE: Electronics 
LANGUAGE: Basic09 
STZE: SI I4E 

DESCRIPTION: Electronic circuit 
network design/ analysis tool There 
was one error in the program that 
is easily fked. Change: 

IF HCS=T H OR THEN 
OPEN ffoutpath^/Pr 

to: 

IF HCS= M Y" OR HCS^v" THEN 
OPEN #ouipath/\' 
PI^WRITE 


NOTE: / PI couJd be /P depending 
on what your printer driver is set to 
USE: network <cr> the program 
prompts you for a fileneme if you 
have a previously saved ".net** file or 
for manual data entry. You have the 
option of editing data points but not 
of saving them from this program, 
I like the feature of using a data file. 
One cardinal rule about computers 
and data, you should never have to 
enter the same data into a computer 
by hand more than once. This fea- 
ture can change any program into a 
very powerful routine. 1 did notice 
that this program wiU not evaluate 
DC circuits so donY try using a 
frequency of zero hem r The output 
(either CRT or hardcopy) gives you 
output frequency in hertt, gain in 
decibels 1 and the associated phase 
angle in degrees. You have a choice 
of either a linear scale or a log scale 
for frequencies. This is a great toot 
for designing filters and such. El 
handles passive as well as active 
devices such as resistors, capacitors, 
inductors, field effect transistors, 
NPN transistors, and operational 
amplifiers. The help file "network- 
Jitiw 11 is very comprehensive, Sev- 
eral rv?itTiJ*t^ 44 npt*" flips rr inrluderf 
to provide you with extra help in 

understanding how the program 
works. 

AUTHOR: Carl R. Kreider 
Based on article sin EDN Magazine; 
schnider 10/5/27, Niemeyer 2A8U 
and Sterner oss 9/ 1/82. 

NAME: fasLfourier 

TYPE: Math, data analysis package 

LANGUAGE: Basic09 

S1ZE:S16FE 

DESCRIPTION: This algorithm 
performs fast fourier transforms 
and inverse transforms on data 
(number of samples must be a power 
of two). Many periodic functions 
such as square waves or triangular 
valves are really just a combination 
of sinusoidal terms. The square 
wave for example is derived by 
adding all of the odd harmonics of 
a sine wave together. The techniques 
used today to represent such func- 
tions was first presented in 1K22 by 
a famous French mathematician 
and physicist Jean-Baptiste Joseph 
Fourier Today these mathematical 
series are known as Fourier series. 
The transform is a technique for 
going from data mapped in the 
frequency domain to the lime do- 
main. You can also go back from the 
time domain to the frequency do- 
main. 


USE: fastJfourier <cr> menu 
driven you have the option of load- 
ing in a file or entering data in by 
hand. Another neat feature of this 
program allows you to 2s2a2v2e 
your data to a file! 
AUTHOR: Greg Morse 


N AME: linefit 

TYPE: Math, data analysis/ statis- 
tics 

LANGUAGE: Basic09 
S1ZE:SI060 

DESCRIPTION: Provides you 
with three equations that eahc min- 
imize the X distance, the Y distance, 
and the perpendicular distance from 
each data point to a line. 
USE: linefit <cr> all data must be 
entered by hand 
AUTHOR: Greg Morse 
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NAME: normal 

TYPE: Math, data analysis /statis- 
tics 

LANGUAGE: BasicOT 
SIZE: S24] 

DESCRIPTION: Demonstrates 
how to generate ran do numbers 
which have a gaussian distribution 
with a chosen mean and standard 
deviation. 

USE: normal <cr> uses two pro- 
grams rnd-smpl is an important 
routine that generates sample data 
for a normal population. Rnd _smpl 
was derived from "Simulating Sam- 
pling from Normal Populations" by 
Catherine Lilly and Two- Year Col- 
lege Mathematics Readings; Ma- 
Tji^atical Association of America. 

AUTHOR: George Dorner 
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NAME: univariate 
TYPE: Math t data analysis/ statis- 
tics 

LANGUAGE: Basic09 
SIZE: S6CF 

DESCRIPTION: Statistics Pick- 
age provides standard deviation, 
mean, median, minimum and max- 
imum values, range, average devia- 
tion, variance, coefficient variance, 
standard error, skewness. and kur- 
tosis. It also provides population 
parameters. 

USE: univariate <cr> prompts you 
for input — manual data entry 
AUTHOR: George Dorner 


NAME: stdev 

TYPE: Math t data analysis /statis- 
tics 

I AMU \(f\ HasidN 
SIZE: S2D3 

DESCR1TP10N; Subroutine, re- 
quires a mam program to call it. 
Calculates statistical values of inter- 
est for two arrays of up to 2000 
points. Provides standard deviation. 
USE: 

argvar ( *siz f ysiz,x(i),y(i) .statres) 
uiz and ysiz are sizes of array 

Continued on Pag* 20 
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SPECIFICATION FOR SERIAL INPUT/OUTPUT DRIVERS 
FOR THE TANDY COLOR COMPUTER 
AND THE OS-9 OPERATING SYSTEM 


Downloaded from CompuServe 


Section 1.1: Introduction 

All of the Tandy supplied serial 
driven for the Color Computer are 
optimised for driving remote and 
local terminals to the Color 
Computer "Console" These drivers 
are also suitable for general purpose 
serial input-output drivers, but are 
not optimized in that application, [f 
fact SCFMan itself assumes a termi- 
nal and human operator on the acia 
port(&). 

This document is intended to 
serve as a discussion instrument and 
tool in deriving a new class of driver 
for the machine. A prototype driver 
exists and is found in the DL 7, 
(database), of the Compuserve OS- 
9 special interest group, (S1G). This 
driver was written to implement the 
Terminal Communications Pack- 
age, BiTernru and is identified as 
"SICT As this document is being 
created "on-line**, any member of 
the OS-9 community should feel 
free to input comments, sugges- 
tions, and suMestiona to the author: 
Win. L. Brady, 7ttl2fe t 261, 4776~ti 

Car mod y Court, Harwood M<J a 
20776, (301) 952-1761. who assume* 
the maintenance responsibility: 

Section 2.0: Applicable document! 

Tccnical Information Man- 
ual and add end urns Micro ware Sys- 
tems/ Mot o rola / Ta ndy Corpo ra- 
tion^). 

Section 3.1: 

Preliminary Requirements 

1. The driver mutt conform to all 
applicable OS-9 conventions and 
standards extant for device driv- 
ers, in regards to position inde- 
pendent code, uses of the inter- 
rupt facility and device descriptor 
format, including non-fixed de- 
vice addresses. However, the 
driver shall not, necessarily, 
mimic the operation of all bytes 
in the device descriptor format, 
and may re-define any byte that 
if not required for correct execu- 
tion of system modules above the 
driver level, (SCF Man), 

2. The driver shall use interrupts to 
signal the system and user soft- 
ware of each ASCII character 
received, except for p (when avail- 
able), DMA, (direct memory ac- 
cess), devices in which case the 
interrupt shall be generated when 
the port hardware requires ser- 
vice by the user software. For 
DMA devices the interrupt shall 
be user selectable as to generation 
after timeout, (user specified), or 
buffer full. 


3, The receive buffer shall be user 
selectable, and shall not be less 
than 64 characters nor more than 
204B characters, 

4, The Transmitter function of the 
driver may or may not be inter- 
rupt driven, however, if interrupt 
driven shall use a separate inter- 
rupt handler, loaded into the OS9 
IRQ interrupt facility at a lower 
priority than the receiver inter- 
rupt, and meeting the same buffer 
requirements as 3 above. 

5 The driver shall generate user 
definable, (via the device descrip- 
tor, x-off aad x-on), flow control 
characters TOWARDS the host, 
and shall not respond to the same 
characters when received FROM 
the host. 

a) At the users option, via a 
seistat system call, the receiver 
shall generate an x-off charac- 
ter whenever a user specified 
character, {usually IOD, car- 
rtapp i HumY i h- r ec tnrcit hv ttfr 
host. 

b) At the users option, via a 
setstat system call, the receiver 
shall generate an x-off charac- 
ter at a user specified buffer 
count, as specified in the device 
descriptor. 

c) The driver shall automat- 
ically de-select method a) if 
method a) is active and method 
b) is selected, and vice-versa, 
The driver shall guarantee th at 
only one mode is active at any 
given time. The selection of 
one method without deselect- 
ing the other shall not cause an 
error to be generated by the 
driver. 

d) If the driver has sent an x- 
off, it shall not resend it, and 
shall send x-on if either a user 
setable, (via the device descrip- 
tor), buffer count is reached, or 
if a getstat $01 is executed or 
a read is attempted against an 
empty buffer 

5, The driver shall completely con- 
figure the port hardware on the 
I NIT system call. All information 
used by the driver shall be present 
in tbc device descriptor at the 
time of this call 

6, The driver shall completely re- 
configure the port, after the IN IT 
system call by the SSXomST 
setstat call 128. All information 
used by the driver shall be present 
in the device descriptor at the 
time of this call. 


7 P The driver shall provide, as a 
minimum, three "filter" capabili- 
ties. A filter is defined as a criteria 
which a received byte must meet 
prior to its being placed In the 
input buffer by the driver. 

a) One filter which shall 
delete all characters 
GREATER THAN, (ASCII 
numeric value), a byte speci- 
fied in the device descriptor 
(00 signifying filter off) 

b) One Tilter which shall 
delete all characters LESS 
THAN, (ASCII numeric 
value), a byte specified in the 
device descriptor. (00 signify- 
ing Filter off). 

c) One filter which shall de- 
lete all characters EQUAL TO, 
(ASCII numeric value), a byte 
specified in the device descrip- 
tor, (00 signifying filter oft), 

8, The driver shall monitor detected 
parity errors and overruns on the 
port hardware. 

a) Overruns shall be pro- 
cessed by the intemipt handler 
by inserting a user specified, 
(via device descriptor), gra- 
phics character in the input 
buffer. The driver shall not 
generate an error for this con- 
dition 

b) Ffcriiy errors shall be pro- 
cessed as any other character, 
however, the driver may be 


designed to replace any errored 
character with the same gra- 
phics character as in a) above, 

9 P The driver shall reset its buffer 
pointers at user request via a 
seistat call. This is to allow the 
user to "replay** the entire buffer 
contents for a repeat screen dis- 
play function or a "quick print 
feature hS . 

Section 3. A: Optional Driver 
Features 

1 , The driver may have the capabil- 
ity to open and send characters 
directly to the standard output 
path, (screen), however, this cap- 
ability shall be controlled by 
setstat calls, and shall be dese lee- 
table. This capability shall not 
replace any of the capabilities in 
section 3,0. 

2. The driver may have the capabil- 
ity to send characters directly to 
one or two user specified path(s), 
(method of specification TBD), 
however, tlh§ ta*h shatt in*t use 
the primary driver buffer or 
buffer pointers. This feature shall 
be controllable by setstat calls, 
and, if implemented* meet the 
filter requirements in 3.7 a, b and 
c above (this feature would sup- 
port on-line printing and down- 
loads). It is recommended that 
feature automatically select an x- 
off method as specified in 3.4 
above. 


Table 3„#: 

Additional Replacements to Iht "T" dan of Device Descriptors 


Name 

Relative 

Size 

Use 


Address 

(bytes) 


IT,FLB 

tbd 

1 

Greater than filter byte 

IT.FLL 

tbd 

1 

Less than filter byte 

IT.FLE 

tbd 

1 

Equal to filter byte 

IT. BAD 

tbd 

1 

Bad Character {overrun) Graphics 




character 

IT.BUF 

tbd 

1 

Buffer size selection {table entry] 

IT FOR 

S1D 

1 

Same as T class driver but different 




usage see 3 5. a 

IT.M(N 

tbd 

2 

Buffer near empty count for xtm 

IT. MAX 

tbd 

2 

Butler near full count for xotf 

IT.BF1 

tbf 

2 

Buffer t (DMA devices only) 

IT.BF2 

tbd 

2 

Buffer 2 (DMA devices only) 
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POSITIVE ACTION VS. 
NEGATIVE COMMENTS 

by Dale Puckett, Direclor-at-Large 


We users live in a small 

universe. There atenlt too many of 
us. Sure, our favorite operating 
system appears to bt coming out of 
the underground and capturing its 
own spot in the popular press this 


year. But, if we all really want to see 
it succeed and become (he MD- 
DOS equivalent in the 68000 mar- 
keep lace, we must all do our pari. 

"What can I do, 11 you ask? Be- 
come an OS -9 evangelist 


Application for membership in the OS- 9 Users Group 


[..asl: 


Firct: 


Middle 


City; 
Stilt: 


ZIP; 


Phone: { 


Delphi ID: 

CWipulrr Malce and Mode) 


OS-9 Ufd: 
Disk Size: 

i 

t Disk Format: 
Single Sided: 


(I) 

(SMI 


on 


(CoCo) 


(CoCo) 


— (Standard) 


Double Sided: 


fr of tracks: _(J5) (40) 

Other rerfrictiojis, farm at v commtrtU, etc; 


(80.) 


Enclose S25 lo cover ihe first year's membership in Lhe form ol ± pe™L>nal chcL-k 
or mimcy order Please allow Approximately 3-5 weeks for processing your 
membership. The Users Group has a small staff, and applications are averaging. 30 
to SO a week. 

Short])- alter acceptance ol your application for membership, you will receive Lhe 
Current Group newsletter ("MOTD"), and soon after J he "slartcr" diiskctlc UG Disk 
f 0. with software of the type useful in getting you started with both OS -4 and the 
Users group, including a mod™ program 10 as^iit you with CompuServe aoo«$ while 
under OS-9. Additional diskettes may be purchased at a cost of Si each to cover 
the cost of media and postage. 

Mail your application and other correspondence to: 

The OS-9 Users Group 
ATTN: (depart menr) 
9743 University Avenue 
Suue.130 

Des Moines, 1 A 50322 

WhfTe (depart mem) is President, MOTD Edilnr, I ihrarian, Membership, eUv 

Membership dues can be charged to your VIS A or MasterCard Simply enter j-our 
card information below and sign this form. 


Card type: 
Account *: 
Expires: _ 


VISA . 


MasterCard , 


1 


Is this a Renewal? Yes 


No 


Thai's a natural, 111 bet you are 
already doing it, If ] were a fly on 
the wall, I'd hear you telling all your 
MS-DOS friends about the many 
great features you have grown 
to know and love. 

OK s we Ye all marketing to 
the best of our abilities, but T are we 
covering all bases? I don't think so 
because we don't have everything we 
need. If OS-9 is to succeed in lhe 
consumer marketplace it must have 
a reason for being. There must be 
hundreds of application programs 
[hat do jobs that people are tired of 
doing by hand. 

To make this happen we must 
encourage programmers within our 
ranks, We must salute them when 
they move the slate of the an for- 
ward. We must encourage them to 
make hold steps forward with in- 
novative: technique* rather than 
discourage them with our criticism 

1 say these things after reading the 
mail on CompuServe'* SIG 
and on Delphi's Color Computer 
SIG There are a lot of helpful 
people on both of these electronic 
bulletin boards, but there is also 
much criticism. This criticism, espe- 
cially when combined with low sales 
and minimal profit, discourages 
programmers from writing new 
programs. As a result we all suffer 

People criticise Tandy for making 
a business decision when they de- 
signed their implementation. Then, 
they criticize Micro ware for deliver- 
ing the product the customer or- 
dered. They don't stop to realize one 
important baste of the business 
world — the customer is always 
right. 

Frankly, Tandy had a good rea- 
son for every "feature" they put in 


lhe Color Computer imp le me nation 
of OS-9. We may or may not agree 
with the selection made by Tandy's 
designers but we must realise that 
no business decisions are made 
lightly, And to be quite honest, we 
must also realise that if Micro wane 
hadn't been willing to deliver the 
product that Tandy w anted f Tandy 
probably would have chose another 
operating system for the Color 
Computer. Then where would we 
be? 

In the old days the story read, 
"Those who can, do. Those who 
can't, teach." If recent experience is 
any indication that old parable 
might be reworded ever slightly. 
"Those who can, do. Those who 
can't, criticize, ** 

In case you are wondering, this 
column was born as the result of 
several interchanges on one of the 
bulletin boards above, Another use 
took me to task for being positive 
and the debate went back and forth 
for several weeks. 

1 wasn't sorry for being positive 
then. I am not sorry now. The world 
would be a lot nicer place to live if 
more people had a positive attitude. 
Because of this belief, 1 work very 
hard to maintain and project a 
positive attitude even though it is 
very hard at limes. 

As 1 told my adversary, everyone 
deserves a pat on the back every 
once in awhile — especially when he 
is not getting rich in the market he 
is supporting out of pure love, 

If this positive attitude theory 
seems like a lot of hog wash to you, 
1 challenge you to look around the 
business world. I think youll find 
that the companies that project a 
positive "can do" altitude are the 
ones that are getting ahead. Organ- 
izations run by managers who try to 
think of reasons not to do some- 
thing are falling like Hies. 

The bottom line + if you know a 
better way to do something, do it. 
If it's something everyone can use, 
sell it. If not. share it. But, do it. 
And, don't put the other guy down 
just because his approach is a link 
different. 


LETTER TO THE EDITOR 


Gentlemen; 

We have been discussing on 
the GS-9 SIG a new class of 
serial I/O driver for OS -9. I 
have put up a fc4 slraw-man" 
spec in dl7 (SK PEC. DOC), 
You may want to pick it up for 
publication in MOTD 

Bill Knuh 


You'll notice SSPEC.DOC 
in this issue of the MOTD. It's 
always fun for me to he able to 
respond so people that have 
something positive to add to 
the MOTD. Constructive en- 
hancements to the world of 
QS-V are what wil! help it to 
grow into THE operating sys- 
tem of the future. 



at RainbowFest Princeton 
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Came see: Dale L. Puckett, Di rector-at-Large 

Brian ft. Lantz, President 
Bill Turner, Vice President 


Bruce Warner, Editor, MDTD 


Have breakfast Sunday morning with Frank Hogg of 
Frank Hogg Laboratory 

. . .get the straight answer for what's 


coming down the line. 
Breakfast Tickets - $14.00 

Get advance tickets by writing: 

05-9 Users Group 


\9 


ATTN: Breakfast 
Suite 8330 
9743 University five. 
Des Moines, Iowa 50322 
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PIPE OF THE MONTH 


by Kevin Kuehf 


In this article I am going to ihow 
you how to build a simple but pow- 
erful database manager using only 
six common utilities. The procedure 
is very simple and uses only cat, del, 
grep, rename, sort t and tr in three 
steps with one being a pipeline. 

In my example 1 will be building 
a list of addresses in a file called 
"addrbook, 1 The Rle has this format: 

I astn a me , firstname^ad d re ss^c- 
ity, stale ?ip~<cr> 

Seep one is to type this statement: 

OS9: cat> tempfile<cr> 

Kuehl n Kevin ^806 Division Roy* 
d— Valparaiso, IN 


463S3— <cr> 
<eof> 

With this J have used cat to put 
my address in a file named 'temp- 
file/ But why are the tildes in the 
line? The pipeline needs some char- 
acter lo serve as a separator which 
will become a carriage return when 
run through. Why have 1 used the 
tilde? Because I have yet to sec ii in 
an address. Actually the separator 
can be any character you want, but 
I have found the tilde to work best. 
Why have I included a tilde at the 
end of the line when tr will print the 
last carriage return? If you have a 
number of lines that, the search 
string matches, the extra tildes add 


PATCHING STRIP 

by fay Truesdale 


Here is a copy of a message I 
posted in reply to Dive K. about the 
htrip utility: 

Dave* in regards to my previous 
message about the strip utility, The 
problem with the "meaningless 
characters" appears to be fixed by 
changing the LDX #CHAR to 
LEAX CHAR,U as I suggested. 

T believe the "meaningless charac- 
ters" are actually control characters, 
which in my case, cause my Word- 
Pak 11 to perform functions like 
cursor addressing, etc. The descrip- 
tion of the II Write system call in my 
(Color Computer) OS-9 manual 
says that register X is to contain the 
starting address of trie data string to 


be written. From looking at the 
ohjeci code generated by the as- 
sembler, it looks to me like I he 
instructions LDX #CH AR would 
load register X with the value 
SOOOD. The following ISWrite sys- 
tem call would then proceed to write 
the two bytes that are at location 
SOOOD, which could be just about 
anything, and in this case are prob- 
ably seen as control characters by 
my WordPak [[. 

After reading this, I realized it 
would make more sense if you read 
Dave's letter; it is on the OS-9 SIG 
on Subtopic 3 r 

I hope this is correct and makes 
sense, if not please let me know. 


PLACING AN AD IN THE MOTD 


There ire still a tot of people out thert 
thai warn to advertise in the MOTD. So 
whal do they 4q1 

Well, here's the deal? You sun out by 
getting your ad made up (called camera 
ne^dy copy). When that is competed, you 
submit your ad with a chock made out lo 
the Users Group arid send both elk 


Editor, ibe MOTD 
c/fl Bruce N. Warner 
1450 3 FuLttrton Road 
Hale City, VA 

The price for advertising in the MOTD 
Is based on the $iit a location and number 
of trttors (colors limited to black and 
red). This chart explains more com- 
pletely 


SIZE 


REGULAR 

1 -Color 


2-Color* 


SPECIAL (back cover) 
l-Color 2-Colors 


Full Pfcge 
Half Page 
Quarter Page 
EighiK hge 


£400 
$200 

non 

S M 


S4km 

$120 
S 60 


1250 
S 1 25 
$ 62 SO 


won 

S 75 


Rales are higher for the Special issue that will be inserted in RAINBOW majuinf , 
These rates will be published at a later dale. 

Youll hive to make time that youVe included your camera ittdy copy and a check 
for payment made out to the OS-9 Users Group. The deadline for entries is the fint 
of every month for I he issue beginning the following month. 


one blank line in between them. So 
really the only reason it is there is 
for aesthetics. 

The next step is to append this 
information to the end of the file 
'addrbook,' If this file doesn^t al- 
ready exist, then you can simply 
change the previous command to 
send its oulptit to that file Other- 
wise you should use cat, del and 
rename like so; 

OS9: cat addrbook temp file > 
newfile; del addrbook 
tempfile; rename newfile ad- 
rbook<cr> 

This updates 'addrbook 1 to in- 
clude the new information included 
in 'ictnprLle/ In actual use, 1 would 
keep this line in a shell script with 
a simple name such as update If you 
have one, a program such as cp 
which appends to the cud of a file 

if it already exists is a time saver 1 

iLiivg uuc ami ijuai i>pc; 

OS9: cp tempfile addrbood<cr> 

and the computer does the work. 
Also L tempfi]e , can include any 
n um her of new add iti om not j us t 
one as in my example. 

The final step is to get a printable 
output given a search string. My 
address can be found by typing: 

grep Kevin addrbook ! grep 
Ktiehl! tr-/l3<cr> 

Why did I use grep twice? With 


only one I must search for either 
*Kuehr or "Kevin, 1 but not both. 
This way 1 am able to make sure 1 
get my name only, [f I were lo search 
for L Kuehl, Kevin/ grep would be- 
come confused and look foi^Kuehl, 1 
in the file h Kevin' definitely not 
what we want. The first grep 
matches all 'Kevins 1 and the second 
matches only 'Kevin Kuehls 1 then 
sends its output to tr which changes 
all the tildes to carriage returns and 
gives us: 

Kuehl, Kevin<cr> 
806 Division Road<cr> 
Valparaiso, IN46383<cr> 
<cr> 

Why did I put the name at the 
beginning of the lint- lasi name 
first, first name — last? So that a 
sort program would work on the 
name correctly. If I were to type: 

OW: sort adtfrrWk i B frp IN I 
tr~vlKcr> 

1 would be presented with a neatly 
sorted listing of all the people in 
'addrbook 1 who live in Indiana. 

I hope this short article has helped 
you put to use some common util- 
ities and maybe even given you some 
ideas for others. The procedure I 
have laid out should work with any 
set of utilities since I have not used 
any options except for the decimal 
representation of a carriage return 
in tr. 


A PATCH 
FOR MORE STORAGE 

by Sieve Bjork and Pete Lyal! 

(Editor's Nots: The follow mg information is provided courtesy of 
CompuServe.) 

Getting more out of (or perhaps on lo) the Desk Mate disk can be 
as easy as making a few patches to the CCD1SK module. Here are the 
necessary offsets and values, 


Offset 

Old 

New 


lf9 

13 

10 

6 ms step rate 

IfT 

22 

02 

Shorten commands delay 

209 

03 

01 

Drive 0 (front of DS 0) 


02 

41 

Drive J (back of DS 0) 

20b 

04 

02 

Drive 2 (front of DS I) 

20c 

40 

42 

Drive 3 (back of DS 1) 

2e8 

03 

(JO 

6 ms restore 

341 

60 

84 

New CRC value 

342 

da 

df 

New CRC value 

343 

8c 

79 

New CRC value 
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MY CADILLAC FOR THE COCO 

by Richard Johnson, CompuServe OS-9 SIC 


TbU driver was written out of a 
need to support the extra function 
keys on roy keyboard. 1 have the 
"Deluxe CoCo'' keyboard which 
has a true control key 1 an alt key, 
and an Fl and F2 key. It has the 
arrow keys arranged in a cluster and 
has the clear key positioned by the 
+ (§r key. 1 realized that PBJ wasnl 
going to support non-standard key- 
boards, so I wrote this driver. It will 
support any keyboard that has extra 
function keys mapped into the four 
extra slots in the standard key- 
board's matrix. It also allows all 
keys to be reprogrammed to return 
new values. 

Any value may be returned except 
SFF and IFD, which is used by the 
driver internally, $FE, which is used 
for the Caps Toggle value instead of 
the II F that both the standard 
CCIO and Wordftk drivers use. I 
changed it so that the keyboard 
could send all ASCII values (£00 
through J7F), This allows the key- 
board to emulate any keyboard that 


sends single character codes for key 
depressions, Also, those who want 
a DVORJAK keyboard layout can 
have it just by reprogramming the 
key tables. As released the keyboard 
works exactly as before with the 
following exceptions: 

the CLEAR key sends a SOS (or 
Backspace) in both the normal 
and shifted modes, Ctrl-Clear 
sends a rub-out (S7F). 
the CTRL works as the control key 
the ALT is now an excape key and 

sends S I B in all modes 
the FI key sends a (unshiftcd) a 4 \ 
\ (shifted) a T, and (Ctrl) a T 
the F2 key sends a (unshifted) a L\ 
(shifted) a %\ and (ctrl)a"]\ 

1 chose these for convenience in 
k C programming. Using the repro- 
gramming option these keys as well 
as I through 0 and :-@ plus the 
<BREAK> and <Spacebar> keys 
can be changed. Below is a chart 
that shows the positions of alt the 
keys in the Keyboard matrix. 
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Haw To Re program Keys 


The keys are arranged as in the 
Matrix in the keyboard table with 
the h @* key followed by the <ua> 
(uparrow) through <f2> keys. 
There are three tables, each contain- 
ing a slot for each key. To find a key 
in any table use the locations in the 
above table. The keys may be ^pro- 
grammed by using display 
command or by SetStat calls. A 
key's current value may be obtained 
by a Get Slat call. The Control and 
shift keys can only be changed in the 
driver source code and changing 
their values in the tables will have no 
affect on them. 

There are three Display codes, 
each corresponding lo one of three 
tables. The first is 51 D for the 

Tor S*tlt«t - 


Unshifted keys, ihe second is SJE 
for the Shifted keys and finally J IF 
for the Control keys. The use of the 
Display command: 

Display IF {value] {key offset] 

Where "Sir could be either $t F, 
II E or $1 D, for the respective table; 
"value 41 is the new value of the key 
and "key offset" is the offset of the 
key into its table. All values must be 
in Hexidectmal and he of one byte 
in length 

Using the Status Calk works in 
similar ways except the codes for 
each table are 150 unshifted, 1SI for 
shifted and 152 for conirol. The use 
of both the SetStat and GetStat calls 
is described below. 
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Compatibility With Other Drivers 


This Driver, WordPakC, only 
works in a Radio Shack compatible 
mode. Some O-Pafc compatibility 
has been implemented. It is not 
compatible with the standard Word- 
Phk mode. All the functions of the 
Radio Shack CCIO that relate to the 
text screen have been implemented 
and the WordPak driver 3.1 RS 
functions have also been added The 
last page is a chart showing display 

may be changed either by using 
sequences or by the RS compatible 
"05 nn** codes. Note however that 
since the WordPak is only a mo- 
nochrome display board the shape 
and blink rate are changed instead 
of the color. 

Status Calls (Getstat)- 

All of [he CCIO codes are sup- 
ported (including joysticks) except 
the following two — SS,DSTAT, 
which returns graphic screen data, 
and SS.ALFA5, which is dependent 


on a memory mapped display. The 
following O-Pak calls are supported 
as well — 

CODE 131 — last display able char- 
acter — always re- 
turns S7F in A. 
CODE 1 32 — OPik screen size call. 

Don't u&e this call 
included for software 
compatibility. A = co- 
lumns* B = rows mi 
screen (80,24) 
CODE 134 — Cursor Status. A = 
cursor blink rate, 6 
= cursor type (Block 
or UL) 

CODE 135 - Overstrike Mode - 
always in overstrike 
mode. A = 0. 

As the standard CCIO is never 
likely to support these calls, 1 have 
only included them for complete- 
ness. I recommend that you never 
use them in your own programs to 
maintain compatibility with CCIO, 


How to Instill WordPakC and Term 


A - CchJ» risf d*?; 
B- ■ Hw Way Villi* 
X - effnt into t±* TUMi 


First assemble the files WordPik- 
C.a&m and TermC.asm into execu- 
table files. Use the following line: 

OS9: mm WordPakC.asm o=/d0/ 
WordPakC 03Qk;asm TermCa&m 
o=/d0/TermC #20k 

If you have any WordPak drivers, 
just use their install procedure, 
except substitute WordPakC for 
WordPak in the file Boot file. If you 
have Sdisk, do the same for CCIO 
and use the TermC descriptor Term 
for WordPakC, (TermC will appear 
as Term when loaded so no patching 
of Init is needed and new BootFiles 
may be created using it; TermC is 
exactly like the PBJ Term,) 

If you would like a Write only 
version to use along with CCIO, you 
can carefully delete all keyboard 
functions, the keyboard table, the 
Getslat and Setstat Codes for key- 


board use and the diaplay code for 
the Function Key changing and 
make the driver a write only driver 
Then use the following for Read and 
Setstat: 

READ 
PUTSTAT 
clrb 
rts 

And the driver will only be cap- 
able of display This will eliminate 
the dread keyboard lock up that 
comes from trying to use both the 
PBJ drivers and CCIO at the same 
time. Change the name of TermC 
from "Term" to "WP" so that it 
doesn't conflict with the CCIO'* 
Term. 

1 have done the best job 1 could 
on this driver, however, 1m not the 
best assembly language pro- 

Cominuett on Page 12 
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grammer and I'm sure that this 
Driver could stand improvement , 
So if you can improve it go ahead 
and do it! Then kindly drop me a 


note on the OS-9 SIG on Compu- 
Serve. My number is 741 16 S 120I so 
I can see what you\e done. Also be 
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P7S 
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Piazi 

J174 C*0p ^TScC 

LQR 

|E$U3TKSVC 

ONKK^H SiPVICt CALL 

PRZ24 

I'll* 1A01 SETSIfl 

□EEC 


SET CA3UY EWWBEIIUJ 

ppzzi 

f 1M 39 




fS2z* 











* FOTSTAT 




.'AIM 

* 2T3fO7:0rT KEY REFTACPCESIT QF VAULTS 


fl B Z ]-P 

* IS T^Z OKLY DKE IMPLEMENTED 



* 





* it - CODE VOr 




If 111 

* If - ADDRESS OF PATH DESCRIPTOR 



# 1? - ADDRESS PF OT-TCt STATIC STORAGE 

fl fl 2 2 j 
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* Fiji trmcira 




«ZJT 

* 




itz:2 

* 1 - SEW VALUE fit 

EE1 




■ X - CUTSET Of KEY IKTC- TABLE 



■ 




>22i\ 





PPZ4Z 

fill llli PUTSTAT 

CM PA 


IE IT A FUHETIQN WTi. CflAMSI 1 

3*3 4 2 

JUTB 2721 



FDR LllEEilJTED JCEVS 

|pi4 4 

P17D I1ST 

afPA 

*1M 



P1?F 272J 

BEQ 


"P SKIPTE: ^EiS 


plBl Blfl 

EHPA 

1153 


IIH? 

flLOJ ZiEF 

M£ 

GET5BB 

KCiAAEI CALL... 

M.4i 

Pill HJfip3 4J PUTS B 9 

r.r.A: 

— HEBL.FCR JET COKTT-IGL IEV TABLE: 

Iflj" 

P1I9 CI 17 PITS lp 


155 

Dip' pi in f-irn ^ 

■32Sfl 

P1BH ZJI7 

eh: 

■SETS-M 

UTfl i CITT D rv 1:4. i 
Tt r ?Pil P | ^^5J 

1*2 21 

plflD Cipp 

■ZHPB 

IP 

Ipaiz 

PlBF Z3I3 

SLO 



PP3 31 

Jl9l 1404 

PSKS 

& 

C kVW in r i it 


Jill If lp 

TFR 

3C.D 

nH 1™ ^rrcv t i_nT ; iH ^ 

yy ■ -Jt t r_ . i ii j ■ j J 


#1.15 15pl 


A 


PP354 

jut mi 

TFR 

Y,X 

* JTJ4-HTS Ty TA3LE 

PP357 

|1S9 1A 



A ESQ I3f IH'f LOCATIfiCM' 

PpZ9i 

I1U A7A4 

STA 

.S 

Et'ORE NEW VALUE 
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HD EPJIGR 

PP3GJ 

J-Ilfr 19 

PT5 



Wtt 





l|J4l 

|14C 3 IB D| 117 PUTS 4.1 

ILEAY 

KTfTBL.PCH 

■TT rnj-i it t r- T p ' i wp-u -T-k r 

flflzb] 

JlAi 3PE3 

BPA 

rjrs- L B 

JTC-PJ UUJtB 

a.iz34 





IU*i 

|LM 3 11 D| 119 PUTS 5.1 

lEAf 

JFlTBEi,TCR 

GET SHIFTED IZY TABLE 


P1AI 2 IDF 

EPA 

PCMTR 


Ha 44 





flaw 

* TE3UfIWATI{iN RttJTIh'E 



IIZTpl 

■ 




Mm 

* SDCI THIS ROUTINE IS NEVE1 REALLY 


112" 

* PEftfOftHED fT 13 HDT HEC 

^SSAPY 


MS 1 ! 


HI "A:". 


IP3 7 4 

i 




3*JVi 






*LfcA 31 PI TOM. 

PSH3 
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J J J ■ ■ 
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fSlf 


|1AE DC4B 

LDD 

fl.ALTIHq 


P3Z79 

|lBf DDJ2 

9TD 

□ .iftg> 


PIJ 

1132 3511 

?::r.s 



pd;;i 
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■P3fl4 
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PP2Bfi 
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PP3BT 

* U-STAT :c 5TCHAGE 




PA 2 B-t 
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P.BZB? 
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112" 

P114 3|CflJ+ READ 

LEAK 

fXFBUF.V 
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CET Tttl UKATTOP fliF THE I1TP0T 

11293 

P197 E6Cllf 

LI:-B 

SET LAST EDCAfl CffT 

||2S4 

P1BA 1ASP 


II3P 

DISABLE IBTEHDPTS 

M1« 
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BUTIH.IT 
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w« 
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Big 
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ELSE 

132 S B 
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P1C2 AtifA 
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WW 
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Man 

PLC? J3f 1 

r;^ 
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Mill 
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CLRB 
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PICA E7CB37 

STB 
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SAVE -OUTPUT POIPTTOt 

M W 

P1CD 1UI 


ill" 

REfTOJtE IHTEBUPffl 

MW 

|1CF 39 READS 

ETS 



MW 





MSJT 

|1PP Mii PEAOLS 

IDk 


TELL CALLER 

Wit 
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try 
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Mill 
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M3U 

P1DE 1141 

LDX 

?P|*B 

5ET FRK DUOIIPTOR 

M31* 

P1EP E«II9« 

LDB 

i3«.X 
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OZM 


¥ESi SEVERS E [JOCK DOOfBITISK 

PJH4 

|24S 2 BOB 


BHA 

JTG30 

RETUjUSJ 

PtHT 

|Z4T EfiCBZ* 

STC ! M 

LIB 

HCIFZh . "J 

CHECK rPPJT lOFFtft 

ppa«i 

|24A 33C914 


LEAK 

INPBVF H 0 

flfll£4 

P24D 3A 


AUX 



flfl'T 2- 

.rp ^ ■■ p" 

|14E 9C 


INCBI 



^p «■ * 

p3*F CITT/ 


an 

lidPsiz-i 

I? NOT FVLL STORE THE KE"V 


P3"9l 31P1 



ST0RJ5 
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THE NEW 
COLOR COMPUTER 


Otntinutdfrom Page I 

by 24-line text display that is 

achieved by typing WIDTH 80. Add 

to that the eight background and 

foreground colors for the TEXT 

screen and a blinking cursor and 

underlining. 

To best utilize the features of the 
Color Computer 3, Tandy has intro- 
duced a new RBG Analog monitor 
to lake full advantage of the system 
hardware and provide 16 colors out 
of the palate of 64, 

Other features include the docu- 
mented 1,7 MHz clock; 32K ROM; 
I28K RAM (Standard, internally 
expandable to 512K); a 57-key key- 
board including Control, Alternate, 
Fl and F2; test display capabilities 
of 32 s 16 f 40 x 24 and 80 x 24; color 
graphics capabilities, ranging from 
64 x 32 (eight colors) to 640 x 192 
(four colors) with six intermediate 
display Formats including two dis- 
plays that offer as much as 320 x 192 
in 16 colors addressable through 
high resolution graphics, Extended 
BASIC and Program Raks. 


I/O ports of the new machine 
include I5IKJ I laud ujssette h two, 2- 
diinensional joysticks, RS-232C 
serial port, standard TV connector, 
composite video, RBG Analog and 
audio in addition to the standard 
ROM slot in the side. 

As if this isn't enough, you have 
noi heard the best news yet. This 
Color Comptuer lists for S2IOS! 
There's at least one vendor that is 
already listing this machine at the 
SI 80 range. 

When the Color Computer 3 is 
turned on, it has a few jobs to 
perform It starts by jumping into 
the internal ROM at SC000. This 
begins the process of copying the 
ROM to RAM and patching the 
ROM for the new commands. The 
new commands actually start at 
SE000. Once completed, a short 
routine is copied into lower RAM 
where it then switches to the exter- 
nal ROM and checks for the pres- 
ence of a DISK ROM and whether 
it isverison 1.0 or LI of RS-DOS 



COMPUTERWARE 


OS-9 Library 

largest selection of OS-9 software anywhere! 


Sourcerer 

tterxj driver, symbolic EBi? dLsu^en- 
bler produce syndic sogrcf cad* 
-.r.:!-. ten r. :"■ ^-.=.1 -r : r : with t &t 
or-siiefltlers t*at use A5CU 

Advanced Utilities 

K5HELL allows wildcards wlUi any 
utility! tftCludei PATH far null 1 pit 
po£h directories, ukOAD fee repeti- 
tive LFlSnhs, FUJK, for alterative 
boot files, a*£h]yE to bockup large 
nedig to SffoLL rNJd^o, 4 CPv. 

CaCc 

Dish Fist & Utilities 

Supports *>ubl « "is del, ftjgb 8 e - den* 1 1 y 
drives with (hi w Off tracks A step 
rates to &ns. Aisa lriclmJes CncOE y 
MTCH, FTLFLWK, I COMPARE. 
Supcarts bath 1.X I 2.X. 

Tex tools 

utilities ft' -ncripu'ciLing teat 
flies. 

Co to S5-50 $*9,S5 

Lock A Listen 

HLtes scree* is 27% ^astE^ t saves 
ovu- J L 5*. Sotfid utilities for sound 
without hsrdwere & srjver, deKMpt* 
or, i cwiwnd fcr Had id Shnc* SSC. 
Net cofc&otibLe with oS-9 ?.* 

CdCh !2f P 95 

Business Applications 

Comprehensive General ledger, Chech 
Ledger, Inventory, Accounts PovObLt,. 
Accounts Receivable, 1 Pnyra]]. 

To Order 

Add $2 surface Or S5 air 
.Khfppin£, Calif residents 
add 6% sales t$x. 


RAID Debugger 

A screen anented debugger with 
built-in dLJ&sse*tola<\ slrgie step, 
newer y window. s,hel] KCttt, A more? 

CoCd 

rtacro Conditional 
Assembler 

Supfwrts oil nanftjrd «^u«nks I 
directives plus thrives, an flocras. 
ccr.Jit iv r zl assent ly. repeal se- 
quences, t source library fllfli. 

CdDo 149. 35 55-50 

Advanced Editor 

Full features line editor for 
prcgraflining ar fce*t_ Edits ^iSes 
1 firmer than nemcry. 

CoCa 5S-50 

Text For matter 

Iiit«rfHes with any editor's ASCII 
te*t flits to produce fceautLf-l 
flacunertat t on , 

Mo 534.95 5S-50 t^._95 

The Lost Word 

The ultimate serif n word processor 
for 05-g. Fsst on-screen fcrraattinq,. 
pop-do*^ wngj, WOfd-Pok ™*ia:l&le. 
Edits files larger than mefwry, 

toCa 

OS-9 BASIC 

Full fwturwl, wsv-tO-vSfp high 
level language. Supports arcphLcs ( 
Joystick fur ^jCo. Bv iovohing 0S-9 
COHWdl yc-j con write ytllUl*V 

CoCd 5^9.95- SS-H %1AM 
Ask for our free catalog! 


compute nmftE 

Box 663 

Encini^s, CA 92024 
(619) 436-3512 



OS-9 Ustra Group Prudent Britn La nil (left) and CompuServe SvsOp Wtynt 
Djv discuss the new Tandy Color Computer at Ihe press conference in N*w 
York. 


Since the DOS mm also be patched 
to access the new commands, this 
operation is both logical and prac- 
tical. The problem comes when 
some other DOS is used, such as A- 
DOS or J-DOS. These enhanced 
operating systems tend to stretch 
past IDFKK, which will overwrite 
the enhanced EC B commands. They 
also overwrite the check for DOS 

1.0 and U, so the Cqlor Cnrnnujer 
3 is unable to determine the version 

of RS-DOS and dctjuli* to none, 

Some of the paiches to ECB in- 
clude the ability lo LPEEK and 
I POKE all 5I2K or RAM This is 
the only area of basic that recog- 
nizes more than I28K K but may 
provide the information necessary 
for 512K spreadsheets in fiO- 
columns. 

Errors can now be trapped 
through the ON ERROR, ER'NO 
and ERLIN commands. There *s 
also an OH BREAK command. 

The frrebuitofi can now be recog- 
nized with the BUTTONN function, 


removing the need to remember 
where to PEEK the tirebulton. 

The text screen is no longer li- 
mited to 32 x 16. which presents 
another problem. PR1NT@ Ls not 
compatible in the 40 and 80-column 
modes. To fix this problem, the 
LOCATEU,y) functions has been 
added to position the cursor on the 
screen. The remaining test screen 
commands are H STAT f which fzives 
the character, attribute* and cursor 
information) and the ART com- 
mand to set the tent screen fore- 
ground and background colors, as 
well as the blinking and underline 
functions. All of the remaining 
Enhanced ECB commands are gra- 
phics oriented. 

By this lime next month, I hope 
to have had the time to run up my 
OS-9 Level It Color Computer and 
give yon the run-down on what 
software runs and doesn*t run. Until 
then . , . 1 think you'll love the 
newest addition to the Tandy line to 
home computers. 



In New Ynrk h Fa I soft Preside lit Lonnif Falk (left) and RAINBOW M>!H&in[ 
Ediior Jim Heed (right) h>nk "1 the n*w Color Computer with Tundy Buyer 
Bif ry Thompson, 
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HEY, ALL YOU OTHER GUYS 


by George Dorner 


Let's get i his straight at the outset. 
I like my CoCo! ] itally like the 
MOID. 1 like the UG Software 
Library. In fact, I like almost ever- 
ything a bom OS-9 . . .especially the 
growth of the OS-9 user community 
But there is a tiny concern I have 
which goes hack to (/-sense me while 
I stroke my beard) the days before 
Tandy embraced our favorite oper- 
ating system and brought the 
broader exposure to OS-9 and the 
jump in membership for the UG. 

Much of the appeal and much of 
the fun of the early (and tiny T) 05- 
9 community and Users Group were 
not due just to the knowledge that 
we were on to something good, 
something which was ahead of its 
time, something which was sophis- 
ticated and elegant. The breadth of 
the backgrounds of those involved 
and the scope of interests and appli- 
cations of those using OS-9 in- 
trigued most of us, ] am sure. I have 
always been impressed at the great 
variety of folks I have met at the 
Microwarc seminar? and even at the 
monthly meetings of our OS-9 
group in Chicago It B s fascinating to 
rub elbows with users from major 
industrial firms, a major university, 

good entrepreneurial idea which 
may use OS-9. 

But I fret occasionally that, be- 
cause most of the work being done 
for the UG just now is being done 
by users with at least one foot 
planted firmly in the CoCo world, 
some mem hers or outsiders will get 
the feel that OS-9 is only for the 
CoCo, Worse, [ worry that many 
OS-9 users may not experience the 
breadth and variety just alluded to 
and that this may limit or slow the 
growth of OS-9. That would be a 
shame, especially now that OS-9 is 
catching on in many quarters, and 
the number of applications is grow- 
ing. 

What to do to avoid "OS-9 my- 
opia," the disease of only seeing one 
or two of the trees and missing the 
forest? Here's an antidote: Let's 
have more exposure for some of 
those OS-9 applications which most 
of us don't realize are going on. Let's 
hear about those VARs, OEMs, and 
OS-9 licensees who are outnum- 
bered by the many CoCo users, SS- 
50 hobbyists, basement C hackers, 
who are so well represented here in 
the MOTD now. Let's hear the tales 
of how OS-9 is running on machines 
we didn't knou existed, with soft- 
ware we would all give our left disk 
drive for, and in countries the names 


of which we don't know how to 
pronounce. Tell us the stories of the 
research labs or corporate offices 
which use an OS-9 system innocu- 
ously and modestly out performing a 
host of MS-DOS machines at some 
crucial tasks. 

Well, one thing is sure. If nobody 
knows about such applications, 
nobody wilt write about them, and 
t he my op ia wi 1 1 cont inue, So, all you 
other guys, if yon have an interest- 
ing or different OS-9 story to tell, 
dash off a few paragraphs and do 
yourself and the rest of us some 
good. 

I know the stories are out there, 
and I will illustrate. I have talked to 
lots of OS-9ers in the past three 
years. I often end up talking long 
distance to some OS-9 zealot far 
away for long periods of time. One 
good member of the UG used to cadi 
me from various points around the 
country because he had no OS-9 
Li) ci t acts and had this Lust to talk to 
someone. . . anyone! . . . about tree 
directories, pathnames, pipes, and 
whether OS-9 would ever have any 
graphics support, 1 still get those 
calls, and I regard that as a real 
bonus of my association with the 

I Ve had a bunch of these contacts 
in the past week, and the breadth 
and variety of the OS-9 community 
really came through, One of these 
was a chat with a long-lime acquain- 
tance who is doing a development 
job on a system in which OS-9 will 
control 64 (count 'em!) 68000s. 
When this system is in production, 
you will probably be able to use one 
in your community ... but without 
knowing that OS-9 is there. No 
more details until then. 

[ also talked to a developer who 
is putting together a 32-bit 68020 
system on the VME buss with some 
really impressive performance 
benchmarks, 9-track tape support, 
and plans to market it as a business 
machine These folks arc hoping to 
beta test the &8Q20 version of OS-9 
which has a new file manager for 
sequential blocks (SBFMAN?) and 
full memory management. Again, 
wait a couple of months for details. 

A call came from Michigan From 
a CoCo hobbyist who had run his 
office on DynaStar and DynaCalc 
for over a year before installing a 
QT and moving over to Sculptor 
with great satisfaction both in the 
performance of the software and the 
hardware. His firm serves the auto 
industry, and while hearing a pitch 
from one of the biggies on a new 


UNIX system he queried whether 
the UNIX system being quoted 
would outperform OS-9 in his appli- 
cation. The sales folks look a few 
moments to recall what OS-9 was, 
but then they acknowledged that 
OS-9 was probably faster for that 
application. 

Finally, I just had the opportunity 
to use OS-9 on the IBM XT in our 
office! A friend called to ask if 1 
would want to try out one of the 
TLM co- processor boards he had 
just purchased for their company 
He didn't have to ask twice! We 
plugged it in and Kill report on our 


findings next month, His firm is 
considering using it in a VAR appli- 
cation for real-time security moni- 
toring, and they may place such a 
system with a customer so that a 
secretary can process words under 
MS-DOS while OS-9 is living in the 
same machine performing their 
applications. This is a real applica- 
tion of "If you can't beat 'em, 

All this OS-9 news in just a week! 
OS-9 is indeed alive, and wel^ and 
growing. [ have been a littJe close- 
mouthed in describing the projects 
since all of them are still under 
development. But I hope everyone 
will write up details when the smoke 
clears and the projects are in place. 
We all will be a little richer and a lot 
prouder for knowing more about 
OS-9 being used in scientific, indus- 
trial business, or whatever applica- 
tions. (I would like to hear more 
about the Australian music synthes- 
izer using OS-9,) 
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FLEXy - afi SK'D0S\ 0S~9* Level I e« level 1L or OS-S ESK 
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